home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 98 / Skunkware 98.iso / html / src / relnotes.tmpl < prev    next >
Text File  |  1998-07-29  |  36KB  |  849 lines
  1. <HTML>
  2. <HEAD>
  3.   <TITLE>Skunkware 98 Release Notes</TITLE>
  4. </HEAD>
  5. <BODY BGCOLOR="#ffffff">
  6.  
  7. <P><TABLE CELLSPACING="0" CELLPADDING="0" WIDTH="100%" BORDER="0">
  8. <TR ALIGN="LEFT" VALIGN="TOP">
  9. <TD ROWSPAN="2" WIDTH="20%"><IMG SRC="gif/skunkware.gif" HEIGHT="80" 
  10. WIDTH="108" ALIGN="BOTTOM"></TD>
  11. <TD VALIGN="BOTTOM" WIDTH="80%">
  12. <MAP NAME="skunknav">
  13.     <AREA SHAPE="rect" COORDS="347,1,460,25" 
  14.           HREF="http://www.sco.com/skunkware/uw7/relnotes.html">
  15.     <AREA SHAPE="rect" COORDS="252,1,331,26" HREF="credits.html">
  16.     <AREA SHAPE="rect" COORDS="112,2,236,26" HREF="index.html">
  17.     <AREA SHAPE="rect" COORDS="3,1,93,25" HREF="index.html">
  18. </MAP>
  19. <IMG SRC="gif/skunknav.gif" BORDER="0" WIDTH="466" HEIGHT="26" 
  20.     ALIGN="BOTTOM" USEMAP="#skunknav" ISMAP></TD></TR>
  21. <TR>
  22. <TD VALIGN="TOP">
  23. <IMG SRC="gif/relnotes.gif" WIDTH="382" HEIGHT="26" ALIGN="BOTTOM"></TD>
  24. </TR>
  25. </TABLE>
  26. <P>
  27. <HR>
  28. <P>
  29. <B>Table of Contents</B>
  30. <P>
  31. <UL>
  32. #ifdef SKUNK_CD
  33. <LI><A HREF="#latest">Updates to these notes</A>
  34. #endif
  35. <LI><A HREF="#what">What is it ?</A>
  36.     <UL>
  37.     <LI><A HREF="#intro">Introduction</A>
  38.     <LI><A HREF="#license">Licensing</A>
  39.     <LI><A HREF="#categories">Software Categories</A>
  40.     <LI><A HREF="#serious">Serious Tools</A>
  41.     <LI><A HREF="#fun">Fun Stuff</A>
  42.     <LI><A HREF="#experimental">Experimental Research</A>
  43.     <LI><A HREF="#disclaimer">Disclaimer</A>
  44.     </UL>
  45. <LI><A HREF="#starting">Getting started</A>
  46.     <UL>
  47.     <LI><A HREF="#mounting">Mounting the Skunkware 98 CD-ROM</A>
  48.     <LI><A HREF="#browsing">Browsing the Skunkware 98 HTML documents</A>
  49.     <LI><A HREF="#moving">Making room for the Skunkware 98 software</A>
  50.     <LI><A HREF="#inst">Installing the Skunkware 98 software</A>
  51.        <UL>
  52.        <LI><A HREF="#inst">Installing all of the Skunkware 98 software</A>
  53.        <LI><A HREF="#part">Installing Skunkware 98 software sets</A>
  54.        <LI><A HREF="#indi">Installing individual Skunkware 98 components</A>
  55.        <LI><A HREF="#audi">Installing the Open Sound System audio drivers</A>
  56.        <LI><A HREF="#conf">Configuring your system for use with Skunkware 98</A>
  57.        </UL>
  58.     <LI><A HREF="#removing">Removing the Skunkware 98 software</A>
  59.     </UL>
  60. <LI><A HREF="#other">Accessing on other platforms</A>
  61. <LI><A HREF="#source">Source Code Distribution</A>
  62. <LI><A HREF="#tls">Technical Library Supplements</A>
  63. <LI><A HREF="#config">Default package configurations</A>
  64.     <UL>
  65.     <LI><A HREF="#apache">Apache port and document root</A>
  66.     <LI><A HREF="#squid">Squid port and accelerator</A>
  67.     <LI><A HREF="#gcc">Two (2) GNU C compilers (FSF and EGCS)</A>
  68.     <LI><A HREF="#htmlman">HTML documentation in /usr/local/man/html</A>
  69.     <LI><A HREF="#sw98mount">Serving the Skunkware 98 HTML documents</A>
  70.     <LI><A HREF="#inn">INN creates user "news" and group "news"</A>
  71.     <LI><A HREF="#xmcd">Xmcd install prompts for CD make and model</A>
  72.     <LI><A HREF="#netpbm">Netpbm binaries in Glib package</A>
  73.     <LI><A HREF="#perlmod">Additional Perl modules</A>
  74.     <LI><A HREF="#perl505">Perl 5.005 installation</A>
  75.     <LI><A HREF="#wmconf">Alternate window managers' default configurations</A>
  76.     <LI><A HREF="#wmaker">Individual account configuration of  WindowMaker</A>
  77.     <LI><A HREF="#xbuffy">XBuffy default mailboxes</A>
  78.     </UL>
  79. <LI><A HREF="#limits">Known limitations and problems:</A>
  80.     <UL>
  81.     <LI><A HREF="#disk5">Disk space consumption on OpenServer 5</A>
  82.     <LI><A HREF="#msql">Installing the Mini SQL relational database system</A>
  83.     <LI><A HREF="#ldap">LDAP slurpd program not included</A>
  84.     <LI><A HREF="#xgrab">Xfishtank/Xdoom/Xgrab/Xgrabsc need a PseudoColor visual</A>
  85.     <LI><A HREF="#vartmp">No /var/tmp on OpenServer 5.0.4 and earlier</A>
  86.     <LI><A HREF="#winman">Alternate window managers</A>
  87.     <LI><A HREF="#kde">The K Desktop Environment (KDE)</A>
  88.     <LI><A HREF="#wmexit">Exiting the alternate window managers</A>
  89.     <LI><A HREF="#mcexit">Exiting Midnight Commander under WindowMaker</A>
  90.     <LI><A HREF="#xboing">Xboing minimum height</A>
  91.     <LI><A HREF="#freefont">Adding freefont directory to your font path</A>
  92.     <LI><A HREF="#man5">OpenServer man command search directories</A>
  93.     <LI><A HREF="#audio">Xdoom/Xgal need -nosound argument if no audio</A>
  94.     <LI><A HREF="#makecd">Makecd limitations</A>
  95.     <LI><A HREF="#osr5g++">OpenServer g++ notes</A>
  96.     <LI><A HREF="#endo">Endo default window sizes</A>
  97.     <LI><A HREF="#xlincity">Xlincity needs PseudoColor visual</A>
  98.     </UL>
  99. </UL>
  100. <P>
  101. <HR>
  102. <P>
  103. #ifdef SKUNK_CD
  104. <A NAME="latest"><B>Updates To These Notes </B></A>
  105. <P>
  106. The very latest Release Notes for Skunkware 98 can be found at
  107. <A HREF="http://www.sco.com/skunkware/relnotes.html">
  108. http://www.sco.com/skunkware/relnotes.html</A>
  109. or
  110. <A HREF="ftp://ftp.sco.com/skunkware/relnotes.html">
  111. ftp://ftp.sco.com/skunkware/relnotes.html</A>
  112. <P>
  113. #endif
  114. <A NAME="what"><B>What is it ?</B></A>
  115. <P>
  116. <DL>
  117. <DT><A NAME="intro"></A>
  118. <DD>
  119. SCO Skunkware is the generic name for a free collection of software 
  120. prebuilt for SCO systems. This distribution is Skunkware 98
  121. and is targeted mainly at the SCO OpenServer platform. To obtain SCO
  122. Skunkware pre-built for use on UnixWare, see the
  123. <A HREF="http://www.sco.com/skunkware/">SCO Skunkware Web Site</A> 
  124. or you may wish to
  125. <A HREF="http://www.sco.com/offers/">order the Skunkware 7 CD</A>.
  126. <P>
  127. Distributions are released on CD periodically and a repository of this 
  128. and previous distributions as well as updates and corrections can 
  129. always be found at 
  130. <A HREF="http://www.sco.com/skunkware">
  131. http://www.sco.com/skunkware</A>.
  132. <P>
  133. SCO Skunkware is software for entertainment, education,
  134. experimentation, and often real work.   It is provided
  135. for free and is not formally supported by SCO.
  136. <P>
  137. <DT><A NAME="license"></A>
  138. <DD>
  139. The software on the Skunkware 98 CD-ROM is licensed under a variety
  140. of terms. Much of it is licensed under the terms of the 
  141. <A HREF="info/gpl.html">GNU General Public License</A>.
  142. Some is licensed under the
  143. <A HREF="info/lgpl.html">GNU Library General Public License</A>.
  144. Other components are licensed under the
  145. <A HREF="info/Artistic">Artistic License</A>. Many of the components are
  146. "freeware" with no restrictions on their redistribution while a few components
  147. are "shareware" meaning the author would like you to try the software and,
  148. if you wish to use it, send her some money. A few components are commercial
  149. products which can be used freely for non-commercial purposes (e.g. msql).
  150. Some components simply restrict their use to non-commercial purposes.
  151. <P>
  152. To determine the licensing conditions for a particular component, see the
  153. corresponding source in the <A HREF="src">source directory</A>. With the
  154. infrequent exception of SCO proprietary code, all Skunkware components are
  155. accompanied by the source used to build them. The source is archived in
  156. <A HREF="src/CONTENTS.html">the src subdirectory</A> by category.
  157. The categories are:
  158. <CENTER>
  159. <P>
  160. <DT><A NAME="categories"></A>
  161. <TABLE BORDER=6 CELLSPACING=3 CELLPADDING=3 WIDTH="100%">
  162. <TR><TH COLSPAN=9>Skunkware 98 Software Categories</TH></TR>
  163. <TR>
  164. <TD ALIGN=CENTER><A HREF="src/audio">
  165. audio</A></TD>
  166. <TD ALIGN=CENTER><A HREF="src/emulators">
  167. emulators</A></TD>
  168. <TD ALIGN=CENTER><A HREF="src/libraries">
  169. libraries</A></TD>
  170. <TD ALIGN=CENTER><A HREF="src/shellutil">
  171. shellutil</A></TD>
  172. <TD ALIGN=CENTER><A HREF="src/fileutil">
  173. fileutil</A></TD>
  174. <TD ALIGN=CENTER><A HREF="src/mail">
  175. mail</A></TD>
  176. <TD ALIGN=CENTER><A HREF="src/sysadmin">
  177. sysadmin</A></TD>
  178. <TD ALIGN=CENTER><A HREF="src/db">
  179. db</A></TD>
  180. <TD ALIGN=CENTER><A HREF="src/net">
  181. net</A></TD></TR>
  182. <TR><TD ALIGN=CENTER><A HREF="src/textproc">
  183. textproc</A></TD>
  184. <TD ALIGN=CENTER><A HREF="src/devtools">
  185. devtools</A></TD>
  186. <TD ALIGN=CENTER><A HREF="src/interp">
  187. interp</A></TD>
  188. <TD ALIGN=CENTER><A HREF="src/news">
  189. news</A></TD>
  190. <TD ALIGN=CENTER><A HREF="src/video">
  191. video</A></TD>
  192. <TD ALIGN=CENTER><A HREF="src/editors">
  193. editors</A></TD>
  194. <TD ALIGN=CENTER><A HREF="src/lib">
  195. lib</A></TD>
  196. <TD ALIGN=CENTER><A HREF="src/shells">
  197. shells</A></TD>
  198. <TD ALIGN=CENTER><A HREF="src/www">
  199. www</A></TD></TR>
  200. <TR><TH COLSPAN=9>X11 Graphical Categories</TH></TR>
  201. <TR><TD ALIGN=CENTER><A HREF="src/x11/apps">
  202. apps</A></TD>
  203. <TD ALIGN=CENTER><A HREF="src/x11/fonts">
  204. fonts</A></TD>
  205. <TD ALIGN=CENTER><A HREF="src/x11/games">
  206. games</A></TD>
  207. <TD ALIGN=CENTER><A HREF="src/x11/graphics">
  208. graphics</A></TD>
  209. <TD ALIGN=CENTER><A HREF="src/x11/misc">
  210. misc</A></TD>
  211. <TD ALIGN=CENTER><A HREF="src/x11/savers">
  212. savers</A></TD>
  213. <TD ALIGN=CENTER><A HREF="src/x11/utils">
  214. utils</A></TD>
  215. <TD ALIGN=CENTER><A HREF="src/x11/viewers">
  216. viewers</A></TD>
  217. <TD ALIGN=CENTER><A HREF="src/x11/winman">
  218. winman</A></TD>
  219. </TD></TR></TABLE>
  220. </CENTER>
  221. <P>
  222. <DT><A NAME="serious"></A>
  223. <DD>
  224. Many of the components of SCO Skunkware may be viewed as productivity and
  225. development tools to be taken seriously. Don't let its whimsical nature
  226. fool you. Examples of serious tools on Skunkware 98 include:
  227. <UL>
  228. <LI>The GNU C Compilation system
  229. <LI>Mtools - DOS filesystem manipulation tools
  230. <LI>Scripting languages (Tcl, Tk, Python, Expect)
  231. <LI>Internet/Network tools (apache, squid, xdir, ldap, many more)
  232. <LI>Editors and text processing tools (xcoral, xemacs, ghostscript, vim, xhtml)
  233. <LI>Many many more
  234. </UL>
  235. <DT><A NAME="fun"></A>
  236. <DD>
  237. Of course, Skunkware also contains fun stuff. Gotta have something to keep
  238. the polecats entertained thru the night. Examples include:
  239. <UL>
  240. <LI>Games (xdoom, xgalaga, xboing, xpool)
  241. <LI>Graphics (mathematical recreations, animation viewers, image manipulators)
  242. <LI>Audio (audio players and editors, mixers, CD players, games with sound)
  243. <LI>Stuff (view astrology charts, graphical fish tank, lots more)
  244. </UL>
  245. <DT><A NAME="experimental"></A>
  246. <DD>
  247. Several of the components on this CD should be considered experimental.
  248. Consider Skunkware a research tool. Examples:
  249. <UL>
  250. <LI>Egcs, the Experimental GNU Compilation System from Cygnus.
  251. <LI>Alpha or pre-release versions of window managers and graphical tools
  252. <LI>A variety of Java classes and applications from Acme Laboratories
  253. <LI>VRwave, a Java based VRML 2.0 browser
  254. <LI>Endo, a tool for exploring dynamical systems in the plane
  255. </UL>
  256. <P>
  257. <DT><A NAME="disclaimer"></A>
  258. <DD>
  259. <P>Remember, Skunkware is freely distributed and <I>unsupported</I> software.
  260. No warranty is made on any of the Skunkware components. Support and assistance
  261. with this software is not provided by SCO. In many cases, however, an e-mail
  262. to <A HREF="mailto:skunkware@sco.com">skunkware@sco.com</A> describing any 
  263. problem you might have may result in a reply/fix/solution. And ...
  264. <CENTER>
  265. <P><FONT SIZE=-2>
  266. "The Santa Cruz Operation, Inc. and SCO Skunkware are not
  267. related to, affiliated with or licensed by the famous Lockheed
  268. Martin Skunk Works (R), the creator of the F-117 Stealth Fighter,
  269. SR-71, U-2, Venturestar(tm), Darkstar(tm), and other pioneering
  270. air and spacecraft."</FONT></CENTER>
  271. </DL>
  272. <P>
  273. <A NAME="starting"><B>Getting Started </B></A>
  274. <P>
  275. <UL>
  276. <LI><A NAME="mounting">Mounting the Skunkware 98 CD-ROM</A>
  277. <P>
  278. [Note that it is not necessary to mount the Skunkware 98 CD-ROM
  279. in order to install the custom installable packages. See the section
  280. below on <A HREF="#installing">installing the Skunkware 98 software</A>.]
  281. <P>
  282. To mount the Skunkware 98 CD-ROM on an SCO UnixWare system, use the command:
  283. <PRE>
  284.     # mount -r -f cdfs /dev/cdrom/c1b0t0l0 /<I>mount-point</I>
  285. </PRE>
  286. where <I>mount-point</I> refers to the full pathname of the directory on
  287. which you wish to mount the CD-ROM (e.g. /mnt).
  288. Note also that the CD-ROM device name may vary from system to system
  289. (the exact name for the cdrom device is usually the only entry in /dev/cdrom).
  290. <P>
  291. On an SCO OpenServer Release 5 system issue the command:
  292. <PRE>
  293.     # mount -r /dev/cd0 /<I>mount-point</I>
  294. </PRE>
  295. <P>
  296. <LI><A NAME="moving">Making room for the Skunkware 98 software</A>
  297. <P>
  298. The installation of all the Skunkware 98 components requires about 500 MB 
  299. of free space on the root partition (/opt/K/SKUNK98). If your root partition
  300. does not have sufficient space, or you wish to utilize an alternate filesystem
  301. for the Skunkware 98 components, prior to installing Skunkware 98 create
  302. a symbolic link in /opt/K as follows:
  303. <PRE>
  304.         # mkdir /u/skunk98
  305.         # cd /opt/K
  306.         # ln -s /u/skunk98 SKUNK98
  307. </PRE>
  308. The above commands assume a separate /u filesystem with sufficient disk space.
  309. The exact name of the alternate filesystem mount point is system dependent.
  310. <P>
  311. You may also wish to place your /usr/local file hierarchy on a separate
  312. filesystem. To do so, create the appropriate symbolic link - e.g.
  313. <PRE>
  314.     # ln -s /u/local /usr/local
  315. </PRE>
  316. <P>
  317. <LI><A NAME="inst">Installing the Skunkware 98 Software</A>
  318. <P>
  319. The installation of all the Skunkware 98 components requires about 500 MB 
  320. of free space on the root partition for OpenServer (/opt/K/SKUNK98). 
  321. <P>
  322. <A NAME="part">
  323. After mounting the Skunkware 98 CD (mount -r /dev/cd0 /mnt), as root run
  324. the command:</A>
  325. <PRE>
  326.     # /<I>mount-point</I>/INSTALL
  327. </PRE>
  328. The Skunkware INSTALL script
  329. will allow you to select from a menu of Skunkware "software sets" including
  330. All Components, Development Tools, Shells, Audio/Video Components, etc.
  331. The INSTALL script acts as a front-end for a non-interactive installation
  332. using the Software Manager (/etc/custom).
  333. <P>
  334. Alternatively, an interactive graphical installation can be performed by 
  335. running the Software Manager (/etc/custom) as root. 
  336. Select "Software" -> "Install New".
  337. If your Skunkware CD is inserted in the local CD-ROM drive, install from the
  338. local host and select the appropriate CD-ROM drive as the Media Device.
  339. <P>
  340. After the Software Manager has read the Skunkware product database, you can
  341. select which components you wish to install or choose to install the full
  342. product (see <A HREF="#moving">notes above on disk space considerations</A>).
  343. <P>
  344. <B>NOTE:</B> <I>A full installation of SCO Skunkware 98 will consume over
  345. 500 Megabytes of disk space and take a couple of hours</I>.
  346. <P>
  347. <A NAME="indi">
  348. To install an individual package, execute the command:</A>
  349. <PRE>
  350.     # custom -p SKUNK98:default:Package -i -m /dev/rcd0
  351. </PRE>
  352. where "Package" is the name of the desired component. See the file
  353. <A HREF="osr5/COMPONENTS.html">
  354. /<I>mount-point</I>/osr5/COMPONENTS</A> for the list of available components.
  355. <P>
  356. <LI><A NAME="audi">Installing the Open Sound System audio drivers</A>
  357. <P>
  358. <OL>
  359. <LI> You should remove any audio drivers you currently have
  360.    installed.  The important thing is that you remove
  361.    them from the kernel.  If you have an older copy of the
  362.    OSS drivers installed, you may be able to remove them
  363.    from the kernel by running "/usr/lib/oss/Remove".  On
  364.    a different note, the SCO PnP driver should be enabled.
  365.    If you had an older version of the OSS drivers, the SCO
  366.    PnP driver might have been disabled.  The file
  367.    "/etc/conf/sdevice.d/PnP" should contain a line like
  368.    so (with "Y" in the second field):
  369. <PRE>
  370.     PnP    Y    1    0    etc. etc....
  371. </PRE>
  372.    while /etc/conf/sdevice.d/pnp should have "N" in the
  373.    second field, if that file exists.  If not, make the
  374.    appropriate changes, rebuild the kernel with:
  375. <PRE>
  376.     /etc/conf/bin/idbuild
  377. </PRE>
  378.    and reboot.
  379.  
  380. <LI> Run "scoadmin isa" or "/etc/pnp" (should be the same thing)
  381.    to do plug-and-play configuration if your card is plug-and-play.
  382.    If you don't know whether your card is plug-and-play, you
  383.    can find out by running this command.  If you see your card
  384.    listed, it's plug-and-play.  If not, it's not.  If it is
  385.    plug-and-play, make sure it is configured and make note of
  386.    the resources it is configured to use.  At this point, the
  387.    resources must be re-entered manually in the audioconfig
  388.    utility.
  389.  
  390. <LI> Run "/usr/lib/audio/audioconfig/audioconfig".  Choose the
  391.    "add card" button.  Choose your card or, for plug-and-play,
  392.    choose "autodetect".  Enter the appropriate resources
  393.    for your card, and press okay.
  394.  
  395. <LI> If you have problems, email <A HREF="mailto:skunkware@sco.com">
  396.      skunkware@sco.com</A>.  Otherwise, reboot and
  397.    test the soundcard.  One way to do that is to re-run the
  398.    audioconfig program and use the "test" button.  Alternatively,
  399.    find a .au file and "cat myaufile.au > /dev/audio".
  400. </OL>
  401. <P>
  402. NOTES:
  403. <P>
  404. <OL>
  405. <LI> This is an early availability release of the OSS audio drivers.
  406.      For subsequent releases, check
  407.      <A HREF="http://www.sco.com/download/">http://www.sco.com/download/</A>.
  408. <LI> You must do the plug and play configuration as a separate step
  409.    before running audioconfig, as described above (if you have
  410.    a PnP card, that is).
  411.  
  412. <LI> Once the soundcard is configured, it is not active until you
  413.    reboot.  So, for example, don't bother clicking the "test"
  414.    button until you reboot.  :)
  415.  
  416. <LI> The audioconfig utility will display some stuff in the xterm
  417.    while it is running.  This is for debugging purposes and will
  418.    help me figure out what is wrong if you run into trouble.
  419. </OL>
  420. <P>
  421. <LI><A NAME="conf">Configuring your system for use with Skunkware 98</A>
  422. <P>
  423. If, as root, you are running the X.Desktop, then you can configure your
  424. system to mount the SCO Skunkware 98 CD-ROM by double-clicking the System
  425. Administration folder -> Filesystems -> Filesystem Manager. Alternatively,
  426. at a root shell prompt, type "scoadmin f" to bring up the Filesystem Manager.
  427. Next select Mount -> Add Mount Configuration -> Local and enter /dev/cd0 for 
  428. the device and a mount point. Change the "Can Users Mount" 
  429. to Yes and uncheck the "At System Startup" mount. After completing this 
  430. operation, you should be able to mount and unmount the SCO Skunkware 98 CD-ROM 
  431. by typing "mnt <I>mount-point</I> and "umnt <I>mount-point</I> as any user.
  432. <P>
  433. <P>
  434. After completing the installation of the Skunkware 98 components you desire,
  435. you may wish to add /usr/local/bin to your PATH and /usr/local/man to your
  436. MANPATH. You may also wish to add /usr/local/java to your CLASSPATH. It should
  437. not be necessary to add /usr/local/lib to your LD_LIBRARY_PATH as the
  438. Skunkware 98 shared libraries have been built with the appropriate flags.
  439. <P>
  440. <LI><A NAME="browsing">Browsing the Skunkware 98 HTML Documents</A>
  441. <P>
  442. For an introductory tour, point a web browser at 
  443. <A HREF="index.html">
  444. /<I>mount-point</I>/index.html</A>
  445. <PRE>
  446.     # /usr/bin/X11/netscape file:/<I>mount-point</I>/index.html
  447. </PRE>
  448. If you do not have Netscape Navigator installed, download a trial copy from
  449. <A HREF="http://www2.sco.com">http://www2.sco.com</A> 
  450. or (for OpenServer) install NCSA Mosaic off of this CD:
  451. <PRE>
  452.     # custom -p SKUNK98:default:Mosaic -i -m /dev/rcd0
  453. </PRE>
  454. or use any browser that supports tables and open the URL file:/<I>mount-point</I>/index.html
  455. (assuming you mounted the CD on /<I>mount-point</I>).
  456. <P>
  457. If you do not have or want a graphical browser, you can install Lynx 2.7.1
  458. (a character browser) off of this CD (OpenServer only, if you are running
  459. UnixWare 7 then Lynx is included by default).
  460. <PRE>
  461.     # custom -p SKUNK98:default:Lynx -i -m /dev/rcd0
  462. </PRE>
  463. Then execute the command:
  464. <PRE>
  465.     # lynx file:/<I>mount-point</I>/index.html
  466. </PRE>
  467. <P>
  468. SCO Skunkware 98 contains files suitable for installation on
  469. SCO OpenServer systems with the Software Manager facility (/etc/custom). 
  470. In addition, there are compressed archives of pre-compiled utilities
  471. which can be extraced manually. Finally, there are 
  472. <A HREF="src/">hundreds of source archives</A>
  473. (almost everything on the CD is accompanied by the source used to build it).
  474. <P>
  475. <LI><A NAME="removing">Removing the Skunkware 98 software</A>
  476. <P>
  477. On SCO OpenServer systems, use the Software Manager (/etc/custom) to remove
  478. Skunkware 98 components. This can be done interactively by running custom and
  479. selecting the component(s) you wish to remove, or non-interactively by
  480. issuing a command like the following:
  481. <PRE>
  482.     # custom -p SKUNK98:default -r <package-list>
  483. </PRE>
  484. <P>
  485. <A NAME="other"><B>Accessing the CD on other platforms</B></A>
  486. <P>
  487. On any other system, after mounting or otherwise making the High-Sierra
  488. Rockridge CD-ROM filesystem accessible, point your WWW browser to
  489. <I>mount-point</I>/index.html where <I>mount-point</I> indicates
  490. the UNIX directory or Windows drive representing the CD-ROM.
  491. <P>
  492. <A NAME="source"><B>Source Code Distribution</B></A>
  493. <P>
  494. In almost all cases, source code is also provided, so you can rebuild 
  495. for earlier SCO releases or other platforms. A full source archive for
  496. this and previous Skunkware releases is available at either
  497. <A HREF="http://www.sco.com/skunkware/src/">
  498. http://www.sco.com/skunkware/src/</A>
  499. or
  500. <A HREF="ftp://ftp.sco.com/skunkware/src/">
  501. ftp://ftp.sco.com/skunkware/src/</A>.
  502. <P>
  503. Source code is provided in the <A HREF="src/CONTENTS.html">src directory</A>.  
  504. In some cases, source code is provided but no
  505. compiled binaries. The source distributions are in gzip-compressed
  506. tar or cpio format. In order to extract these, use the command:
  507.  
  508. <PRE>
  509.     $ gzcat /<I>mount-point</I>/src/<directory>/<package>.tar.gz | tar xf -
  510. </PRE>
  511.  
  512. or, in the case of a compressed cpio archive:
  513.  
  514. <PRE>
  515.     $ gzcat /<I>mount-point</I>/src/<directory>/<package>.cpio.gz | cpio -icdu
  516. </PRE>
  517.  
  518. Where <directory> refers to the top-level source directory
  519. and <package> is the package name (e.g. gzip-1.2.4).
  520. <P>
  521. If you do not have gzcat installed (part of the gzip package), you can
  522. install it off of the SCO Skunkware 98 CD via the command:
  523.  
  524. <PRE>
  525.         (OpenServer systems)
  526.         # custom -p SKUNK98:default:GZIP -i -m /dev/rcd0
  527.  
  528.         (UnixWare 7 systems)
  529.         # pkgadd -d /<I>mount-point</I>/uw7/gzip.pkg
  530.  
  531.         (UnixWare 2.x systems)
  532.         # pkgadd -d /<I>mount-point</I>/uw2/gzip.pkg
  533. </PRE>
  534. <P>
  535. <A NAME="tls"><B>Technical Library Supplements</B></A>
  536. <P>
  537. You may also find the 
  538. <A HREF="ftp://ftp.sco.com/TLS/">SCO Technical Library Supplements </A>
  539. to be of interest. These are drawn from the 
  540. <A HREF="http://www.sco.com/support/">SCO Support Online System</A>,
  541. and are accessible via anonymous ftp on the Internet from 
  542. <A HREF="ftp://ftp.sco.com">ftp.sco.com</A>
  543. or via web facilities at 
  544. <A HREF="http://www.sco.com">
  545. http://www.sco.com</A>
  546. <P>
  547.  
  548. <A NAME="config"><B>Default Package Configurations</B></A>
  549. <P>
  550. Many of the Skunkware packages contain configuration files. In order to
  551. avoid excessive user interaction during installation and to provide a
  552. consistent and well integrated set of configurations, the Skunkware 98
  553. packages have been pre-configured (with the exception of xmcd which will
  554. prompt you for your CD-ROM make and model; and inn which may prompt for a
  555. "news" user password).
  556. <P>
  557. Generally, you will not need to alter the default configurations but you
  558. may choose to do so. Some of the package pre-configurations are as follows:
  559. <UL>
  560. <LI><A NAME="apache">
  561. The Apache web server is configured to run on port 8080</A>. If you are not
  562. going to use Squid as an httpd accelerator, you may wish to run the Apache
  563. web server on port 80. To do so, modify /usr/local/lib/apache/etc/httpd.conf.
  564. Further, the default document directory for the Apache web server is set to
  565. /usr/local/lib/apache/share/htdocs. If you wish to serve your HTML documents out
  566. of a different location, modify /usr/local/lib/apache/etc/srm.conf and
  567. /usr/local/lib/apache/etc/access.conf
  568. <LI><A NAME="squid">
  569. The Squid Internet Object Cache is configured to run on port 80</A> and to 
  570. act as an httpd accelerator for the server running on port 8080 (by default,
  571. the Apache web server). If you wish to use this default configuration,
  572. remember to stop/disable any other server running on port 80. In particular,
  573. the Netscape FastTrack server is usually configured to run on port 80.
  574. <LI><A NAME="gcc">
  575. Skunkware 98 contains a custom installable integrated GNU compilation system.
  576. This includes both the Free Software Foundation's GNU C Compiler and Cygnus' 
  577. experimental GNU C Compiler (EGCS).
  578. The file /etc/default/gcc can be used to specify which is the default
  579. preferred compiler. The entries in this file set the system-wide default.
  580. An individual user can override this default by setting and exporting the
  581. PREFERRED_GCC environment variable. This variable must be set to either
  582. /usr/local/lib/front-fsf or /usr/local/lib/front-egcs. If set incorrectly,
  583. the system will revert to the preference specified in /etc/default/gcc.
  584. <LI><A NAME="htmlman">
  585. Several packages install documentation, manuals, tutorials and other</A>
  586. introductory and informative matter as HTML documents in /usr/local/man/html.
  587. During the installation of these packages, a symbolic link is created in
  588. the default Apache web server document root. Thus, the documentation for
  589. these packages can be accessed via a browser. For instance, the HTML documents
  590. describing the Xcoral editor are installed in /usr/local/man/html/xcoral.
  591. A symbolic link pointing to this location is installed as
  592. /usr/local/lib/apache/htdocs/docs/xcoral. Thus, to access the Xcoral HTML 
  593. documentation, you need only open the URL http://your.server.name/docs/xcoral/
  594. These convenience links are provided for Count, SmallEiffel, addressbook,
  595. crossfire, gd, giftrans, gimp, git, gv, GNU history, Hypermail, jasmin,
  596. klassmaster, lxrun, mathrec, msql, mutt, mysql, nedit, omniORB, php,
  597. GNU readline, sox, squid, tcsh, vrwave, wget, wwwtar, xacc, xcoral, xtar, 
  598. xtide and xv.
  599. <LI><A NAME="sw98mount">
  600. If you mount the CD-ROM under your default document root, </A>
  601. you will be able to serve up the Skunkware 98 HTML documents
  602. with your web server. For instance, after installing the apache and squid
  603. packages, if you mounted the Skunkware 98 CD-ROM on 
  604. /usr/local/lib/apache/share/htdocs/skunkware, then opening the URL
  605. http://your.server.name/skunkware/ would allow you to browse the contents
  606. of the Skunkware 98 CD-ROM from any browser that could access your server.
  607. <LI><A NAME="inn">
  608. The INN installation is configured to install many of its files owned </A>
  609. by the user "news" and group "news". During the inn package installation,
  610. this user/group is created if it doesn't already exist. If the installation
  611. creates a "news" user, you will be prompted for a password during installation.
  612. <LI><A NAME="xmcd">
  613. The Xmcd (Motif audio CD player) package will prompt you for the CD drive </A>
  614. configuration during the installation. If you wish to configure Xmcd during
  615. the installation, you should know the make and model number of your CD drive(s).
  616. <LI><A NAME="netpbm">
  617. The Netpbm suite of graphical file conversion utilities</A>
  618. are in the Glib package. In order to install these utilities, issue the command:
  619. <PRE>
  620.     # custom -p SKUNK98:default:Glib -i -m /dev/rcd0
  621. </PRE>
  622. They are installed in /usr/local/bin. The Glib package is installed either
  623. during a full installation of Skunkware 98 or as part of the "Development
  624. Tools" software set.
  625. <LI><A NAME="perlmod">Additional Perl modules</A> will be available via 
  626. <A HREF="http://www.sco.com/skunkware/osr5/interp/perl/">
  627. http://www.sco.com/skunkware/osr5/interp/perl/</A>. These include various
  628. database interfaces, ImageMagick enhancements and more.
  629. <LI><A NAME="perl505">Perl 5.005 installation</A> -
  630. Skunkware 98 contains a custom installable Perl 5.004_04 distribution as
  631. well as a gzip'd tar archive of a Perl 5.005 binary distribution. In order
  632. to install Perl 5.005, insert the Skunkware 98 CD in the CD-ROM drive and
  633. execute the following (as root):
  634. <PRE>
  635.     # custom -p SKUNK98:default:Perl -r
  636.     # mount -r /dev/rcd0 /mnt
  637.     # cd /
  638.     # gzcat /mnt/osr5/interp/perl-5.005/perl-5.005.tar.gz | tar xf -
  639.     # umount /mnt
  640. </PRE>
  641. You may also wish to create a link from /usr/local/bin/perl to /usr/bin/perl.
  642. Note that gzcat is in /usr/local/bin.
  643. <LI><A NAME="wmconf">Alternate window managers' default configurations</A>
  644. are those provided in the source distributions and will need to be tailored
  645. for use on OpenServer 5. That is, the rc startup files for fvwm, fvwm95,
  646. AfterStep and WindowMaker may need system-specific
  647. configuration. The Skunkware team plans on making OpenServer specific
  648. window manager configuration files available via the Skunkware web site at
  649. <A HREF="http://www.sco.com/skunkware/x11/winman/">
  650. http://www.sco.com/skunkware/x11/winman/</A>.
  651. <LI><A NAME="wmaker">Individual account configuration of WindowMaker</A>
  652. must be done prior to using the WindowMaker window manager. To do so,
  653. login as the user who desires to use WindowMaker and run the WindowMaker
  654. configuration script:
  655. <PRE>
  656.     $ /usr/local/bin/wmaker.inst
  657. </PRE>
  658. When prompted for the name of the initialization file to use, enter
  659. <I>.startxrc</I>
  660. <LI><A NAME="xbuffy">XBuffy default mailboxes</A> are set in the file
  661. <I>/usr/lib/X11/app-defaults/XBuffy</I>. In order to get xbuffy to monitor
  662. your personal mailboxes, you will need to add a line similar to the following
  663. to your $HOME/.Xdefaults :
  664. <PRE>
  665. *mailboxes:     /usr/spool/mail/wfp:/home/wfp/.mailbox:/home/wfp/nsmail/Inbox
  666. </PRE>
  667. replacing the user name wfp with your own.
  668. </UL>
  669.  
  670. <P>
  671. <A NAME="limits"><B>Known Limitations and Problems</B></A>
  672. <UL>
  673. <LI> <A NAME="disk5">A full installation of the SCO Skunkware 98 </A>
  674.   media images for SCO OpenServer
  675.   requires approximately 500 Mb of disk space. If your system's root filesystem
  676.   does not contain sufficient disk space (a check is performed at the
  677.   beginning of the installation), then you may wish to perform the following
  678.   workaround (rather than removing files from the root partition):
  679. <PRE>
  680.       # cd /opt/K
  681.       # ln -s /u/local local
  682. </PRE>
  683.   Where /u/local resides on an additional disk with sufficient space.
  684.  
  685. <P>
  686. </LI><LI><A NAME="msql">Prior to installing the Mini SQL relational database 
  687. management system</A>, it may be necessary to shutdown any existing mSQL
  688. daemon running on port 1114. To do so, issue the command:
  689. <PRE>
  690.     # /usr/local/Hughes/bin/msqladmin shutdown
  691. </PRE>
  692. <P>
  693. </LI><LI><A NAME="ldap">The LDAP slurpd program is not included</A>
  694. in Skunkware 98. Slurpd is the database replication program for the ldap server.
  695. <P>
  696. </LI><LI><A NAME="xgrab">Some programs - including the
  697. xfishtank animated background and the xgrabsc command - may need a 
  698. PseudoColor visual</A>.
  699. Before attempting to run either xfishtank or xgrab, 
  700. the front-end for xgrabsc, 
  701. you may need to configure your X server to run in 256 color mode. Sorry.
  702.  
  703. <P>
  704. </LI><LI><A NAME="vartmp">On OpenServer 5.0.4 and earlier</A>
  705. there may be no /var/tmp directory. Some Skunkware components (e.g. nvi)
  706. may attempt to use this directory for temporary files. A /var/tmp directory
  707. can be created as follows:
  708. <PRE>
  709.     # ln -s /usr/tmp /var/tmp
  710. </PRE>
  711. </LI><LI><A NAME="winman">Alternate window managers</A> - The Skunkware 98
  712. window managers (Fvwm 2, AfterStep, WindowMaker, Kde) should be considered
  713. experimental. Of the four, Fvwm 2 is the most stable and well tested.
  714. Some color-intensive X clients may not be able to allocate sufficient
  715. color cells, particularly with WindowMaker. Additional window managers
  716. and updated versions of these will be available at the 
  717. <A HREF="http://www.sco.com/skunkware/x11/winman/">Skunkware web site</A>.
  718.  
  719. <P>
  720. </LI><LI><A NAME="kde">The K Desktop Environment (KDE)</A>, release 1.0,
  721. was added to Skunkware 98 at the last minute. KDE installs in the
  722. /usr/local/kde directory. Very little testing of kde was possible.
  723. Documentation for KDE can be found at 
  724. <A HREF="http://www.kde.org/documentation/index.html">the KDE web site</A>
  725. and in the Skunkware 98 installation of KDE at http://localhost/docs/kde
  726. (assuming you have installed KDE, Apache and Squid).
  727. <P>
  728. Source for KDE can be retrieved either from the KDE ftp site at
  729. <A HREF="ftp://ftp.kde.org">ftp.kde.org</A> or from the Skunkware ftp site
  730. at <A HREF="ftp://ftp.sco.com/skunkware/src/x11/winman/kde/">
  731. ftp://ftp.sco.com/skunkware/src/x11/winman/kde/
  732. <P>
  733. It is hoped that this remarkable new desktop environment will please the
  734. graphical Skunkware 98 user.
  735. <P>
  736. </LI><LI><A NAME="wmexit">Exiting the alternate window managers</A>
  737. does not always exit the X session and return you to the graphical login.
  738. If this happens, switch to another screen (ctrl-alt-fkey) and kill the
  739. X server process for your display:
  740. <PRE>
  741.     # ps -ef | grep X
  742.     # kill <pid>
  743. </PRE>
  744.  
  745. <P>
  746. </LI><LI><A NAME="mcexit">Exiting Midnight Commander under WindowMaker</A>
  747. can be difficult as the WindowMaker window manager grabs F10.
  748. <P>
  749. </LI><LI><A NAME="xboing">Xboing minimum height</A> exceeds that of an
  750. 800x600 display. To play xboing effectively, the screen resolution must
  751. be set larger than a 600 pixel height.
  752.  
  753. <P>
  754. </LI><LI><A NAME="freefont">Adding freefont directory to your font path</A>
  755. can be accomplished with the following commands:
  756. <PRE>
  757.     $ xset -fp /usr/local/share/fonts/freefont
  758.     $ xset +fp /usr/local/share/fonts/freefont
  759.     $ xset fp rehash
  760. </PRE>
  761. The gimp command has been wrappered with a shell script which does this for you.
  762.  
  763. <P>
  764. </LI>
  765. <LI><A NAME="man5">
  766.   The SCO OpenServer 5 man command</A> expects the man pages to be in
  767.   directories named man.suffix and cat.suffix. Many public domain
  768.   packages place their manual pages in directories like man1, man8,
  769.   cat1, cat8 and so on. Further, these directories are usually located
  770.   in /usr/local/man rather than /usr/man. To remedy this, add /usr/local/man
  771.   to your MANPATH (see /etc/default/man) and create symbolic links from
  772.   mann to man.n, catn to cat.n and so on.
  773.  
  774. <P>
  775. </LI><LI><A NAME="audio">Xdoom needs -nosound argument if no audio</A>.
  776. If the OSS audio driver is not installed, in order to run the Xdoom
  777. video game you will need to invoke it with the "-nosound" argument. For
  778. instance:
  779. <PRE>
  780.     $ xdoom -nosound
  781. </PRE>
  782. <P>
  783. </LI><LI><A NAME="makecd">
  784.   The "makecd" package</A> is only known to work on SCO OpenServer 5.0.4
  785.   with the HP SureStore 4020/6020 or Philips CDD 2600 CD-ROM writers.
  786.  
  787. <P>
  788. </LI>
  789. <P>
  790. <LI><A NAME="osr5g++">
  791.   On OpenServer, if you use g++ to link an ELF binary, libg++ and libstdc++</A>
  792.   will be linked in automatically, regardless of whether they are
  793.   actually used by your program.  Such binaries will not run on
  794.   machines that do not have the libg++ and libstdc++ shared
  795.   libraries installed.  If you know your program does not need
  796.   these libraries, you can link it using gcc and they will not be
  797.   included.  In programs that do use libg++ or libstdc++, you can
  798.   maintain portability by using the "-static" flag which makes a
  799.   statically-linked binary.
  800.  
  801. <P>
  802. </LI><LI><A NAME="endo">Endo default window sizes</A> may appear too small.
  803. Although the pre-configured scripts in /usr/local/mathrec/endo do create
  804. correct window sizes, invoking the endo program with no arguments may
  805. create windows with a minimum height. If this is the case, simply enlarge
  806. the window(s) by clicking on and dragging the window border(s).
  807.  
  808. <P>
  809. </LI><LI><A NAME="xlincity">
  810.   Apparently xlincity needs a pseudo-color visual</A>. That is, if you have
  811.   configured your video for use with more than 256 colors, xlincity fails
  812.   with "Major opcode of failed request:  89 (X_StoreColors)". If you find
  813.   you can run xlincity in TrueColor mode, let us know.
  814. </UL>
  815.  
  816. <B>Comments</B>
  817. <P>
  818. We are interested in your general comments about this distribution
  819. and about development tools in general. Please feel free to e-mail
  820. <A HREF="mailto:skunkware@sco.com">skunkware@sco.com</A> with
  821. comments, criticisms and suggestions.
  822. <P>
  823. <TABLE WIDTH=100% BORDER=6 CELLPADDING=3 CELLSPACING=3>
  824. <TR><TD ALIGN=CENTER COLSPAN=2>Ronald Joe Record</TD>
  825. <TD ALIGN=CENTER><A HREF="http://www.sco.com/">SCO</A></TD>
  826. <TD ALIGN=CENTER><A HREF="mailto:rr@sco.com">rr@sco.com</A></TD></TR>
  827. <TR><TD ALIGN=CENTER COLSPAN=4>
  828. Senior Engineer for Free Stuff, Skunkware, technical tools, etc.</TD></TR>
  829. <TR><TD ALIGN=CENTER>400 Encinal St.</TD>
  830. <TD ALIGN=CENTER>Santa Cruz, CA 95061</TD>
  831. <TD ALIGN=CENTER>    FAX: 408-427-5417</TD>
  832. <TD ALIGN=CENTER>  Voice: 408-427-7604</TD></TR>
  833. </TABLE>
  834. <P>
  835. <TABLE WIDTH=100% BORDER=6 CELLPADDING=3 CELLSPACING=3>
  836. <TR><TD ALIGN=CENTER COLSPAN=2>Dion L. Johnson II  </TD>
  837. <TD ALIGN=CENTER><A HREF="http://www.sco.com/">SCO</A></TD>
  838. <TD ALIGN=CENTER><A HREF="mailto:dionj@sco.com">dionj@sco.com</A></TD></TR>
  839. <TR><TD ALIGN=CENTER COLSPAN=4>
  840. Product Manager for Free Stuff, Skunkware, technical tools, etc.</TD></TR>
  841. <TR><TD ALIGN=CENTER>400 Encinal St.</TD><TD ALIGN=CENTER>  Santa Cruz, CA 95061
  842. </TD>
  843. <TD ALIGN=CENTER>    FAX: 408-427-5417</TD>
  844. <TD ALIGN=CENTER>  Voice: 408-427-7565</TD></TR>
  845. </TABLE>
  846. </BODY>
  847. </HTML>
  848.  
  849.